package com.ztorn.fiscale.service;

import java.util.List;
import com.ztorn.fiscale.domain.FiscaleRefundMatching;

/**
 * 配单记录Service接口
 * 
 * @author ztorn
 * @date 2025-09-20
 */
public interface IFiscaleRefundMatchingService 
{
    /**
     * 查询配单记录
     * 
     * @param matchingId 配单记录ID
     * @return 配单记录
     */
    public FiscaleRefundMatching selectFiscaleRefundMatchingById(Long matchingId);

    /**
     * 查询配单记录列表
     * 
     * @param fiscaleRefundMatching 配单记录
     * @return 配单记录集合
     */
    public List<FiscaleRefundMatching> selectFiscaleRefundMatchingList(FiscaleRefundMatching fiscaleRefundMatching);

    /**
     * 新增配单记录
     * 
     * @param fiscaleRefundMatching 配单记录
     * @return 结果
     */
    public int insertFiscaleRefundMatching(FiscaleRefundMatching fiscaleRefundMatching);

    /**
     * 修改配单记录
     * 
     * @param fiscaleRefundMatching 配单记录
     * @return 结果
     */
    public int updateFiscaleRefundMatching(FiscaleRefundMatching fiscaleRefundMatching);

    /**
     * 批量删除配单记录
     * 
     * @param matchingIds 需要删除的配单记录ID
     * @return 结果
     */
    public int deleteFiscaleRefundMatchingByIds(Long[] matchingIds);

    /**
     * 删除配单记录信息
     * 
     * @param matchingId 配单记录ID
     * @return 结果
     */
    public int deleteFiscaleRefundMatchingById(Long matchingId);
    
    /**
     * 取消配对
     * 
     * @param matchingId 配单ID
     * @return 结果
     */
    public int cancelMatching(Long matchingId);
    
    /**
     * 手动关联报关单和发票
     * 
     * @param declarationId 报关单ID
     * @param invoiceId 发票ID
     * @param matchReason 匹配原因
     * @return 结果
     */
    public int manualMatching(Long declarationId, Long invoiceId, String matchReason);
}